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INSTALLATION 



From Diskt 



DPut the product disk into drive 0. 

2)Press the RESET button, i.e. BOOT the system. 

3)The COPYRIGHT notice will appear. If this fails, check that you are using the correct disk 
for your system - Mod I (including Video Genie) or Mod III. 

4)A menu will also be displayed: 

"D" selects the Disk-Overlay version of the Editor. 
"I M selects the In-Core version. 

5)For the in-core version you will be prompted to supply a relocation address. Allow 3534 
bytes from the top of your memory. Alternatively, ENTER alone will automatically relocate 
to the highest address suitable for your system (and will use slightly less than 3534 bytes). 

6)Remove the product disk and replace it by your own system disk. Use a TRSBOS disk for 
pref eren ce. The installation process will work on some other DOS's, but not all. You can 
CONVERT or COPY the installed file from TRSDOS to another DOS, if used. 

7)Press ENTER. (Do not REBOOT!) 

8)The system will now appear to REBOOT, If you have an AUTO command in effect, this will 
be displayed on the screen but it will NOT have been executed. 

?)For the Disk-Overlay version you will now be prompted to reinsert the product disk, and 
then the system disk. For the In-Core version, a DUMP command will be displayed. If either 
of these fail to appear on your system, then use TRSDOS. 

10)The end result of this sequence will be to place a file called EDIT/CMD on your system 
disk. Use this copy directly, or COPY it to a data disk, or another DOS, if necessary. 



The Disk-Overlay version is the easier to use, but it will run only on TRSDOS, LDOS, or 
smal-LDOS. The In-Core version of the Editor runs permanently in memory, and in 
consequence is faster to invoke than the overlay version. It will run on all DGS'es, or even 
on Level2, However you must provide adequate space for it in PROTECTED memory, The 
installation process will ask you to enter the address at which you want the Editor to run, 
When you enter Disk BASIC you must set MEMORY SIZE to this value (or lower if you have 
other programs in protected memory), For the Disk-Overlay version, just enter Disk BASIC 
in the normal way, 

To use either version type 

CMD'TVEDIT" 

when in Disk BASIC, This loads EDIT into memory and branches to its first location, 

"activating" it, For the Disk-Overlay version it also enters full-screen edit mode, For a 

subsequent invocation of the Disk-Overlay version, or for the first invocation of the 
In-Core version, type /EDIT, 



From Taog! 

Refer to the separate sheet, EELOC, for instructions on loading and relocating the tape 
supplied. You need to allocate 35S4 bytes of memory in protected storage for the Editor* If 
you have no other machine code programs in protected memory then answer the "MEMORY 
SIZE?" question as follows' ~ 



Machine Size 


MEMORY SIZE answer 


16K 


29184 


32K 


45363 


48K 


61952 



Use LEVEL II (not Disk. BASIC) to load the tape initially, and to relocate the Editor to the 
appropriate target address for your machine, Then you can dump a 3534-byte core-image file 
either on tape (using TBUG, or Southern Software's TSAVE) or on disk using the TRSDOS 
DTJMF command* If you load the Editor directly from this dumped copy in the future, 
remember to leave enough protected memory for it under LEVEL II or DOS, 

To use the Editor you must first activate it by branching to its first location: 



SYSTEM (enter) 
*? /3SS33 (enter) 
READY 



where 33333 is your chosen starting address of the Editor 



From now on the Editor can be invoked by the command; 

./EDIT 



cautions: 



1) The Editor uses a variable amount of stack space during editinq, as a buffer to hold the 
currently modified line, and as workspace, This can be as much as 500-600 bvtes, So a 
program that only just fits in unprotected memory may cause an CM (Cut-of-Memory) when 

edited, 

2) When you modify a program all EASIC variables are cleared and all files are dosed, If you 
use EDIT to examine a program compiled under one of the ACCELs, clearing the variables in 
this way will mean the program will no longer run unless recompiled, 

3) For NEWDOSS0 or DOSFLUS precede the /EDIT by a blank, 



FUNCTIONS PROVIDED BY THE EDITOR, 

The rest of this documentation applies to all versions of the Editor, After the special 
initial load and activation, you invoke the program in all cases byi 



/EDIT 



or /EDIT nnnn 



or 



/EDIT, 



where nnnn is a line number, (V stands for "current line number"). For the Disk-Overlay 
version you can also use nnnn or , on the initial command, s,g, CMD'TV'EDIT 330", 

For the in-core version you must NOT destroy the Editor in storage while it is activated - 
else BASIC will fail. You can deactivate it by branching to its starting address a second 
time, If you leave BASIC (using CMD"S") while the Editor is activated (or deactivated), you 
can reenter BASIC and reactivate it, without reloading it, However, be aware that the 
SYSTEM command does not work on Model III under Disk BASIC, Use DEFUSR instead* 

Activation enables the /EDIT command, using the "trap" at address HEX'41B3', Other 
programs may use this trap and thereby destroy the activation, so that /EDIT is diagnosed 
as a SYNTAX ERROR, In this case reactivate by branching to the first location again. For 
the Disk-Overlay version, re-execute CMD'^VEDIT". Note that use of ACCEL4 will always 
deactivate the Editor under smal-LDOS, and sometimes also under TRSDOS or LDOS. 



The Display Format 

After ycu use the /EDIT command you will see 15 lines of your program, startina from the 
one you specified on the /EDIT command, or at the beginning of the oroaram if you did not 
specify a line number, The left hand column and right hand column normally contain a 
vertical bar, The bar is broken to show you where program lines spill over into more than 
one line on the screen. The bar at the end of the line kinks to show you when you have 
changed a line, The bar at the left hand end of a line will be changed by the Editor to a 
different - flashing - character to remind you about things you have done to the line, 

The bottom line of the screen is used for messages and commands, 
The Cursor 

At one place on the screen there will be a flashing blob. This is the full-screen cursor. You 
can see the character that is under the cursor as it flashes, Normally when you press a key 
the keyed character is placed where the cursor is (replacing the character that was there). 
The cursor then moves onto the next position, This is the normal way to change characters, 

The four arrow keys on the TRS-SO keyboard enable you to move the cursor without changing 
the characters that the cursor moves over, The cursor moves one step in the direction of the 
arrow each time you press the key. Like all other keys, if you hold an arrow key down for a 
second or so the function of the arrow will be repeated quickly until you release the key, 
This means you can move the cursor all over the screen easily. So you use the arrow keys to 
move the cursor to the characters that you want to change, 

You can do this even if you cannot see the line you want to change - to get to later lines of 
your program, ycu move the cursor down towards the bottom of the screen and keep going! 
The Editor will automatically bring the later lines of your program into view. Similarly, to 
see earlier program lines you try to move the cursor off the top of the screen and the lines 
automatically come into view. This is called "automatic scrolling", 



Special Keys - "BREAK", "^ NTER". "CLEAR", Arrows and »ra» 



^s^B^^-V?? aSPe=iai C °222 nd mode> Tne a*™™* »• described belaw. 
^fnta BAOT '*"** " PrBSSlnS BREAK Whe " in S ^ CDm ™ d ™^> puts you 

*^V«« »y* > %T r T* ' " ' f ill f • i 

; fc lS """ tey commits any changes. You press "CLEAR" if you have changed your mind - 
this causes the operation to be cancelled. Most commands also have the efSrt o"™- 
on operations that have not yet been completed, as does automata scrolling. 

JH^Tey^vou STt^V* ^^ " 7° U PrBSS " arr ° W kE * while Mdi "9 down the 
bii-i-i Key, you can type the arrow as a plain character. The Editor does NOT suonort <•>«! 

P^"S^ ThS neWUne ^ 1S — P« and placed in the 

Jhf X tey !"f S * 5 ^ dal mSaninS tQ the Editor * If y° u wisn to type a plain "fl" then ore-* 
the "0" (zero) key while holding down the SHIFT key/ P 

The (3 Control y P t/ 

-ditor ^es^ S^^^M 8 ^^ tBXt edit °^ the S ° uthe ™ Saft »^ BASIC 
Thp lm« f tt? y I a Shlft key t0 give a s P ecial meanin 9 to the key you press at 
Ihf'J^T tim r„o ^ USed in this way the "0" »«y i* called the "control" keyTln the rest of 
this document -Q/x- means hold down the -Q- key and then press the "X" (for example) 

Extended Cursor Control TT?v<; 
"Q" with numeric keys help you do more things with the cursor! 
0/1 - makes the cursor jump back to the beginning of the current line, 
@/2 - makes the cursor jump to the beginning of the next line 

mS2^ th h S arr ° W ke * 5 f0r thase "■*»■*■ without them. You 

may aiso find them convenient if you have a numeric keypad. 

«£ - Is the s^ne as" ^."ZtTT" *"** IV* ™ VeS *** ajr " r d ° Wn °" e !ine ' 
nZ Jl ' at 1S rt mov es the cursor one character to the left 

8/5 - is the same as ■->■} that is it moves the cursor one character o he richi. 
fl/6 - is the same as the up-arrow! that is it moves the cursor up one lie 

G/7 - lets you insert characters* 

SS m r -«Xt ™ r E? in'L^rt" aP H Pe ."^ n thS b ° tt0m riSht hand CD ™ ° f the s - een " 

nHv™",™V y ^ rt ™ 5de ' The nert time y° u P^ess S/7 the "I" disaooears 

and you return to normal mode. ESTER also ends "insert mode". disappears 

^iVlo^lTrl^^*? '"? y ° U *"* d ° eS " Qt re P lara the *aractar at the 
uie neA/ cnar*crer =a the new character is inserted into the line. 

?o1i?Uhe E ^cl Charart ^ ^^ 1S ^ thS CJr5 ° r P ° Siti0n and ™ ves the «st of the line back 
@/9 deletes the rest of the line starting from the cursor position. ' 
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Ling Commands 

"Q" with a letter is used mainly For commands that operate on whole lines* The line that is 
affected is the one containing the cursor* 

@/L means lock* and is a Shift Lock which switches you from upper case only to upper/lower 
case, or back again* To ensure a valid EASIC program* lower case characters persist only 
inside .quoted strings or remarks* 

Deleting Lines* 

Q/D deletes the line containing the cursor, Actually it just causes a "D" to flash at th= i«ft 
hand end of the line*. When you next press "ENTER" the. line will be deleted* This is a 
special feature to enable you to change your mind* If you decide not to delete the line (for 
example, because you selected the wrong line) press "CLEAR" instead of ENTER* 

You can also delete a line just by deleting all the characters of the line, If a line is blank 
when you press "ENTER" (or the line only contains a line number) the line is automatically 
deleted* J 

Splitting and Joining Lines* 

G/S will split the current line into two lines, at the cursor position, deleting the character 
under the cursor, which will normally be a "J" statement divider* 

Q/J will join the line identified by the cursor with the line below, inserting a "V between 
them* 



Creating New Lines* 

The Editor lets you create lines in several different ways - to save typing* But you should 
be careful how you create line numbers* When the Editor creates a line, it may have the 
same number as an existing line and/or its number is out of sequence with the lines before 
and after it* This is essential to allow you to get the benefit of copying and moving lines* 
When you have created a line with a line number that normal BASIC would not allow the 
Editor flashes a "#" character at the left hand end of the line* You should change the line 
number to a valid one by overtyping the existing one* 

If you return to BASIC while there is an invalid line number in your program you may get 

!^!?r e T ? !? ertS, J bUt yQU Wil1 n0t harm y0Ur P ro 9™n* Go back to the Southern Software 
BASIC Editor and correct- the error* You can even save and reload such a program in the 
normal format but NOT with the ASCII option* , 

The Editor does not duplicate the function of AUTO, and where you have many new lines to 

add ° 1 Zl! ert in yDur P ro 9 ram > You may find it more convenient to exit from the Editor and 
use AUTO* 

Q/T inserts a new line after the line containing the cursor* If you dont type anything into 
the new line before the next time you press "ENTER" the new line will disaooear again* You 
cannot use @/I to insert a line at the top of your program - use Q/R to repeat the top line 
line and update the first version of it, 

@/R replicates the current line* That is it creates an exact copy of the line immediately 
after it* You use this function to save typing when you need to create a similar line. 
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Q/C cooies aline to a specified position. After you press @/C a "C" will flash at *h B i»*f 
hand end of the line that contained the cursor. You then move the cursor to the oroor^m fnl 

:C f !;!,, y ° U T "!" ^ of the line P 1 ^' ^en press @/A if you wa^t the cop'yTlaced 
after' the line with the cursor, or @/B if you want it placed "before the line withSf 
cursor. There can be automatic scrolling between pressing the @/C and ! the f/lor Q/3 T 
can even update lines on the way, or you can use the ••find" command (see larer) to o!t Inu 
where you want the copy of the line, ±ater; to get you 

c^gTtne ^^Xr C oTr nU 5 ££££%$£ ^ *»' ^ "" ^ — to 

^7^^fA5^ ,l I r(£s ,to • Tou use e/M with @/A or e/3 to show whe - «» *» »• 

TOvK™M«H lin * aCCDrdln3 tD "" Une nUmber ' G/? is " •"■nutive way to move or 
^Lt hne ' £***** of co °yi"S ar moving a line and then changing it and/or its line number 
you change the line number, or the line number of a cooy created bv ^/P id t heTuse@/P 

gllen it." m ° Ved tD " S CDrrECt 3eqUEntiaI - DUCE ™ in 9 *> «» Une number you ha-fe 

Block Commands 

0'Q starts a block command. The line containing the cursor when you oress ra/o ■•- th= 
nTrZlJ, bl °% 0f l r 5 J Y ° U the " m ° Ve the ^ t0 the ■"- of fblock of lSf« ^h en 
tath^w" if b ? ^^^ d .^" '^ f ° r a ""* - mm - d ' ™» ^ —and then ^ Het 
whole blocks of lines. X ^ *" C ° Py ' m ° Ve ' re ^ te ' d ^te, ^ portion 

Also note* 

If you change your mind about the beginning of the block, just repeat the ffl/Q command. 

Touan specify the end of the block as a line that is before the beginning. The effect is the 

Tou can use the "find" command to get you to where you want the end of the block to be. 
Block delete happens immediately you press @/D (unlike line delete). 




Special Commands 

ar e y a . U Whpn S in B Sl cnZ^^ £*'££?. T tyPS * Special ^^^ in the ««"»«! 
WUowir.gr command mode the "BREAK", "EHTEE" and "CLEAR" keys mean the 

^ E ofsa"v^o°urpTo y g^ dal ""' IW " *"" Edit0r " d ^ t0 3ASIC ' N °» X* «" 
ENTER - execute the special command and return to normal mode. 

(It your keyboard does not have a CLEAR key you can use @K as an alternative.) 

^TtThp^* 5ped f CDmm , and . y0U Can U5e the nDrmal ^sor functions (arrows and Q/7, 
8, 9) to help you correct mistakes in the special command. The Special Commands are! 

nnnnn where nnnnn is a number between and 65520. 

This positions the display so that at the middle of the screen is the statement with this 
number, or the first statement after the number if there is no exact Ztl^inn^tiAT 

^St" ' ,0n WiH di5Play thS flr5t linSS ° f thS P"*™ and^20-' P wm^ 



Fdxxx...d 



where xxx... stands for up to eight characters, and d is any chosen delimiter. 



™ S ^ S -^S? .-f ° CCurr r^ 0f the *^^r S xxx... starting from where the cursor 
was when BREAK was pressed. When you press ENTER the cursor is moved to <"he first 

^^1^1^ dei ^ it5 I ^ ^ ° mltted UnlS5S y ° U ^ * ^ -ari%or 1 
spring witn .railing blanks. Examples of search strinas are! 

FRETURH F-RETTJRN" F'RET'JEN F READ A F/A-P / ,w, a k, , , 

The characters xxx... are remembered by The Editofso that 'htnln n^afmode^ can 

press @/F to repeat the find using the same string of characters. ' 

Gdyyy...d where yyy... stands for up to sight characters, and d is any delimiter. 

chllSers vv^ are rip"! hV^ "£?* ° Jnm P ° Siti ° n iS re P laCed * W« The 
charters yyy... are remembered by the Editor so that whan in normal mode you can chanoe 

the next xxx... to yyy... by pressing @/G. Thus if you wish to change all ocLr^ncTs of^x 

one^and^eThe^^ ™" ^f^ COmmandt = «* the "«"°" ^ring xxx S find the ^ 
one) and use the G yy» special command to change the xxx to yy and to set the alobal channe 

dSC-h xxX " down the 0/G keys • the Editor •& move ^^T^ 

?h™lV«% to m find f a t n h n° Cm '' rBnCe x 0f ^ W y ° U USS the S ^ e s ? eciaI °™ d = ^ 
nrTJI!™ f " ?1 occurrence of xxx, then press @/G only if you want to change thi= 

occurrence to yy, and then press @/F to go on to the next one. 

L°inT^°^2 n n C f °/ k a f rin S, find it using "F xxx..." and then change it to nothino 
u=,wg .he G command without any string. Hold @/G down to delete further occurrences. 

commlnf^"* Jth™? + ""l" • *" a nUmbar ° f pl = Ce5 5et the find st ring to null using the 
command F without a string, position the cursor to where you want the strino insprtlri 

So" the ™ D to m tr d "V 3 ?-"* THiS WU1 inSSrt th " =*» at thtUsor os fti n T n 

position the cursor to the next place and press @/G, etc. 



Summary of Function g» 



Invocation 



Special Keys 



/EDIT 

/EDIT nnriTfi 
/EDIT ♦ 

BREAK 

ENTER 

CLEAR 

Arrow keys 

SHIFT/0 

SHIFT/arrow 



Control Commands 



Notes,' 



(?/D 
3/1 * 
3/R 

e/c 

9/M 

0/A 

8/B 

3/P 

9/Q 

8/F 

8/G 

8/L 

3/S 

e/j 

e = autonatic "ENTER", b 



be 
e 
eb 

be 

be 
e 
e 

eb 
e c 
e 
e 

c 
e 
e 



invoke Editor at start of program 

invoke Editor at line rmnnn (or next line) 

invoke Editor at "current" line 

enter special connand node, (twice = return to BASIC) 

cortrtit operation and updates, reset nodes 

reset changes since last "ENTER" function, cancel operation 

nove cursor one character in the direction of the arrow 

types the nornal "I?" character 

types the nornal arrow character 

delete line or block of lines 

insert new line 

replicate line or block of lines 

copy line or block of lines 

Move line or block of lines 

after here (use with g/C and 0/M) 

before here (use with g/C and g/M) 

Position line or block of lines 

start of block co*wand 

repeat find operation 

global change operation 

change shift lock 

split line in two 

join two lines to one 



Special Connands 



Cursor Ccwiands 



rmnnn 

F >ccccccc< 

C yyyyyyyy 



= block connand (with S/Q), c = clear will cancel. 

display statement rmnnn 

find next occurrence of xxxxxxxx 
change xxxxxxxx to yyyyyyyy 



The following table is arranged' like the keys on a TRS-80 rubric keypad: 



1 7 x 8 i 9 x 
x insert x delete x erase x 
x node x char x rest x 

x ^ x 5 x 6 x 

* <— X — > x up x 

* * X x 

"XXX^tglXTTm rTTTYTrrrryryrY 

1 1 x 2 x 3 x 
x start x next x down x 
1 of line x line x x 

»^^^^^^^Jl^^ « - "as is" basis. witnout 
to b 9 caused by its use B - p ° nSlblllty ls ««apted ror any loss or damans caused or alieaed 




'/ 



